コンテンツを全体的に修正 #231
Open
コンテンツを全体的に修正 #231
+46
−53
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
kgsi
commented
Jun 27, 2023
kgsi
commented
- ですます口調をである調に変更
- 不要となった用語の削除
- 用語で間違っている点を修正
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
tosiiu
reviewed
Jun 27, 2023
tosiiu
reviewed
Jun 27, 2023
Co-authored-by: Ura Toshihiro <[email protected]>
Co-authored-by: Ura Toshihiro <[email protected]>
uknmr
requested changes
Jun 27, 2023
| @@ -1,42 +1,42 @@ | |||
| --- | |||
| layout: ../../layouts/ArticleLayout.astro | |||
| title: コレクションとシングル | |||
| description: コレクションは、ひとつのビューの中に同種のオブジェクトを複数並べて表示する。シングルは、ひとつのビューでオブジェクトひとつ分を表示する。 | |||
| description: コレクションは、ひとつのビューの中に同種のオブジェクトを複数並べて表示するものである。一方、シングルは、ひとつのビューでオブジェクトひとつ分を表示するものである。 | |||
There was a problem hiding this comment.
「〜する」はですます調でもないので、治す必要なさそう。「〜するものである」という日本語が気になってしまう。
Comment on lines
+17
to
+18
| コレクションは、ひとつのビューの中に同種のオブジェクトを複数並べて表示するもの。 | ||
| 代表的なUIとしては、リストやカードを用いたグリッドレイアウトなどが挙げられる。 |
There was a problem hiding this comment.
Suggested change
| コレクションは、ひとつのビューの中に同種のオブジェクトを複数並べて表示するもの。 | |
| 代表的なUIとしては、リストやカードを用いたグリッドレイアウトなどが挙げられる。 | |
| ひとつのビューの中に同種のオブジェクトを複数並べて表示するものを、コレクションと呼ぶ。 | |
| 代表的なUIとしては、リストやカードを用いたグリッドレイアウトなどが挙げられる。 |
|
|
||
| ## シングル | ||
| シングルは、ひとつのビューでオブジェクトひとつ分を表示するものです。 | ||
| 通常はコレクションよりも多くの属性を表示します。 | ||
| シングルは、ひとつのビューでオブジェクトひとつ分を表示するもの。 |
There was a problem hiding this comment.
Suggested change
| シングルは、ひとつのビューでオブジェクトひとつ分を表示するもの。 | |
| ひとつのビューでオブジェクトひとつ分を表示するものを、シングルと呼ぶ。 |
|
|
||
| コレクションとシングルをレイアウトする際、それぞれを別の画面に分割する方法もありますが、デスクトップアプリケーションなど広い面積が使用できる場合、領域を分割して１つの画面内に配置することも可能です。 | ||
| コレクションとシングルをレイアウトする際には、それぞれを別の画面に分割する方法もあり、また、デスクトップアプリケーションなど広い面積が使用できる場合には、領域を分割して１つの画面内に配置することも可能である。 |
There was a problem hiding this comment.
Suggested change
| コレクションとシングルをレイアウトする際には、それぞれを別の画面に分割する方法もあり、また、デスクトップアプリケーションなど広い面積が使用できる場合には、領域を分割して１つの画面内に配置することも可能である。 | |
| コレクションとシングルをレイアウトする際、それぞれを別の画面に分割する方法もあるが、デスクトップアプリケーションなど広い面積が使用できる場合、領域を分割して１つの画面内に配置することもある。 |
| @@ -5,38 +5,39 @@ description: | |||
| tag: word,サービス | |||
| --- | |||
|
|
|||
| [SmartHR UI](https://github.com/kufu/smarthr-ui) は、[SmartHR](https://smarthr.co.jp/) が [SmartHR](https://smarthr.jp/) を作るために開発した React ベースの UI コンポーネントライブラリです。このライブラリには、一般的な UI 要素だけでなく、業務アプリケーションに特化したコンポーネントも含まれています。開発者はこれらのコンポーネントを組み合わせることで、短期間で複雑な業務アプリケーションを構築できます。 | |||
| [SmartHR UI](https://github.com/kufu/smarthr-ui) は、[SmartHR](https://smarthr.co.jp/) が [SmartHR](https://smarthr.jp/) を構築するために開発した React ベースの UI コンポーネントライブラリである。このライブラリは、一般的な UI 要素だけでなく、業務アプリケーションに特化したコンポーネントも含まれている。開発者はこれらのコンポーネントを組み合わせることで、短期間で複雑な業務アプリケーションを構築することができる。 | |||
There was a problem hiding this comment.
Suggested change
| [SmartHR UI](https://github.com/kufu/smarthr-ui) は、[SmartHR](https://smarthr.co.jp/) が [SmartHR](https://smarthr.jp/) を構築するために開発した React ベースの UI コンポーネントライブラリである。このライブラリは、一般的な UI 要素だけでなく、業務アプリケーションに特化したコンポーネントも含まれている。開発者はこれらのコンポーネントを組み合わせることで、短期間で複雑な業務アプリケーションを構築することができる。 | |
| [SmartHR UI](https://github.com/kufu/smarthr-ui) は、[SmartHR](https://smarthr.co.jp/) が [SmartHR](https://smarthr.jp/) を構築するために開発した React ベースの UI コンポーネントライブラリである。このライブラリには、一般的な UI 要素だけでなく、業務アプリケーションに特化したコンポーネントも含まれる。開発者はこれらのコンポーネントを組み合わせることで、短期間で複雑な業務アプリケーションを構築できる。 |
Comment on lines
14
to
+36
| ### 使い勝手を損なわないこと | ||
|
|
||
| UIコンポーネントの使い勝手は、プロダクトの使い勝手に直結するため非常に重要です。 | ||
| UIコンポーネントの使い勝手は、プロダクトの使い勝手に直結するため非常に重要である。 | ||
|
|
||
| ユーザーエージェントの振る舞いからかけ離れないようにすることやアクセシビリティに取り組むことも使い勝手に関わります。もちろんプログレッシブエンハンスメントな考え方も大切にしています。 | ||
| ユーザーエージェントの振る舞いからかけ離れないようにする。アクセシビリティに取り組むことも使い勝手に関わる。もちろんプログレッシブエンハンスメントな考え方も大切にしている。 | ||
|
|
||
| またコンポーネント単体の振る舞いだけでなく、プロダクトで一貫したUIになっているかどうかも忘れてはいけません。 | ||
| コンポーネント単体の振る舞いだけでなく、プロダクトで一貫したUIになっているかどうかも忘れてはならない。 | ||
|
|
||
| ### 開発者の生産性を損なわないこと | ||
|
|
||
| 私たちは、サービスを通じてプロダクトの利用者や社会に価値を届けることを目的にしています。その状態に早く到達するためにも、質の良いプロダクトを早く開発し早くリリースする必要があります。 | ||
| 私たちは、サービスを通じてプロダクトの利用者や社会に価値を届けることを目的にしている。その状態に早く到達するためにも、質の良いプロダクトを早く開発し早くリリースする必要がある。 | ||
|
|
||
| SmartHR UIはそんな開発を支えるためのプロダクトとして、質が高く、使いやすいコンポーネントを、早く、提供し続けます。コンポーネントの先にあるプロダクトの開発サイクルを妨げないためにSmartHR UI自体の開発サイクルも素早く行なっていきます。 | ||
| SmartHR UIはそのような開発を支えるためのプロダクトとして、質が高く、使いやすいコンポーネントを、早く、提供し続ける。コンポーネントの先にあるプロダクトの開発サイクルを妨げないためにSmartHR UI自体の開発サイクルも迅速に行われる。 | ||
|
|
||
| 複数プロダクトに組み込まれて使われる“プロダクト”だから、良くも悪くもその影響は大きく、単一のプロダクトだけでなく幅広い視野で捉えることも必要です。各プロダクトの意見をまとめてコンポーネントとして展開することで、SmartHR製品全体の質を高める触媒として機能します。 | ||
| 複数プロダクトに組み込まれて使われる“プロダクト”であるからこそ、その影響は大きい。単一のプロダクトだけでなく幅広い視野で捉えることも必要である。各プロダクトの意見をまとめてコンポーネントとして展開することで、SmartHR製品全体の質を高める触媒として機能する。 | ||
|
|
||
| ### オープンソースであること | ||
|
|
||
| SmartHRのプラットフォーム化構想に向けて、サードパーティの開発者がSmartHR APIとSmartHR UIを利用して開発できる状態を目指してオープンソースしています。 | ||
| SmartHRのプラットフォーム化構想に向けて、サードパーティの開発者がSmartHR APIとSmartHR UIを利用して開発できる状態を目指してオープンソース化している。 | ||
|
|
||
| また私たちはウェブが開かれていたから今の自分たちがあると考えているため、日々の仕事で得た知見を積極的に公開していきます。 | ||
| また私たちはウェブが開かれていたからこそ今の自分たちがあると考えているため、日々の仕事で得た知見を積極的に公開していく。 | ||
|
|
||
| SmartHRのために作られたコンポーネントではあるものの、社会の価値に繋がるのであれば競合を含めた他社のtoB SaaSプロダクトで使われることも望んでいます。 | ||
| SmartHRのために作られたコンポーネントではあるものの、社会の価値に繋がるのであれば競合を含めた他社のtoB SaaSプロダクトで使われることも望んでいる。 |
There was a problem hiding this comment.
ここはほぼ引用なので「である調」に変えたくないなと思った。
引用でマークアップした方がいいのかな。
| @@ -5,26 +5,26 @@ description: | |||
| tag: word,開発手法 | |||
| --- | |||
|
|
|||
| ユーザーストーリーは、ソフトウェア開発において、利用者の視点からソフトウェアが提供する価値を表現する短い記述です。ユーザーストーリーは、開発チームがエンドユーザーの要望やニーズに焦点を当て、要件を理解しやすく整理するのに役立ちます。 | |||
| ユーザーストーリーとは、ソフトウェア開発において、利用者の視点からソフトウェアが提供する価値を表現する短い記述を指す。ユーザーストーリーは、開発チームがエンドユーザーの要望やニーズに焦点を当て、要件を理解しやすく整理するのに役立つ。 | |||
There was a problem hiding this comment.
Suggested change
| ユーザーストーリーとは、ソフトウェア開発において、利用者の視点からソフトウェアが提供する価値を表現する短い記述を指す。ユーザーストーリーは、開発チームがエンドユーザーの要望やニーズに焦点を当て、要件を理解しやすく整理するのに役立つ。 | |
| ユーザーストーリーは、ソフトウェア開発において、利用者の視点からソフトウェアが提供する価値を表現する短い記述である。開発チームがエンドユーザーの要望やニーズに焦点を当て、要件を理解しやすく整理するのに役立つ。 |
| 1. **ユーザーストーリーの理解**: デザイナーはユーザーストーリーから利用者がどのような価値を求めているのか理解し、それをデザインに反映させる必要があります。また、デザイナーと開発者がユーザーストーリーを共有することで、プロジェクト全体の目標に対する理解が深まり、効率的な開発が可能になります。 | ||
| 2. **ユーザーストーリーの評価と更新**: ユーザーストーリーを参考にして、利用者のメンタルモデルに沿ったワイヤーフレームやプロトタイプの作成とUIの実装をするなかで、ユーザーストーリーが適切に反映されているか評価し、必要に応じて更新します。また、ユーザーテストやフィードバックを通じて、ユーザーストーリーを改善し、デザインを最適化していくことが重要です。 | ||
| プロダクトデザイナーとして、ユーザーストーリーを扱う方法は以下の2つに集約される。 | ||
| 1. **ユーザーストーリーの理解**: デザイナーはユーザーストーリーから利用者がどのような価値を求めているのか理解し、それをデザインに反映させる必要がある。また、デザイナーと開発者がユーザーストーリーを共有することで、プロジェクト全体の目標に対する理解が深まり、効率的な開発が可能となる。 |
There was a problem hiding this comment.
Suggested change
| 1. **ユーザーストーリーの理解**: デザイナーはユーザーストーリーから利用者がどのような価値を求めているのか理解し、それをデザインに反映させる必要がある。また、デザイナーと開発者がユーザーストーリーを共有することで、プロジェクト全体の目標に対する理解が深まり、効率的な開発が可能となる。 | |
| 1. **ユーザーストーリーの理解**: デザイナーはユーザーストーリーから利用者がどのような価値を求めているのか理解し、それをデザインに反映させる必要がある。また、デザイナーと開発者がユーザーストーリーを共有することで、プロジェクト全体の目標に対する理解が深まり、効率的な開発が可能になる。 |
| 1. **デザインの優先順位付け**: ユーザーストーリーは、デザインの優先順位を決定する際の指標として役立ちます。重要なユーザーストーリーに対応する機能や要素に焦点を当てることで、リソースを効果的に配分できます。 | ||
| 2. **ステークホルダーとのコミュニケーション**: ユーザーストーリーは、プロジェクトの進捗状況やデザインの説明に役立ちます。ステークホルダーがユーザーストーリーを理解することで、デザインの意図や目標について共通の理解が得られ、効率的な意思決定が可能になります。 | ||
| ユーザーストーリーを活用することで、デザイナーは以下のような利点も享受できる。 | ||
| 1. **デザインの優先順位付け**: ユーザーストーリーは、デザインの優先順位を決定する際の指標として役立つ。重要なユーザーストーリーに対応する機能や要素に焦点を当てることで、リソースを効果的に配分することが可能である。 |
There was a problem hiding this comment.
Suggested change
| 1. **デザインの優先順位付け**: ユーザーストーリーは、デザインの優先順位を決定する際の指標として役立つ。重要なユーザーストーリーに対応する機能や要素に焦点を当てることで、リソースを効果的に配分することが可能である。 | |
| 1. **デザインの優先順位付け**: ユーザーストーリーは、デザインの優先順位を決定する際の指標として役立つ。重要なユーザーストーリーに対応する機能や要素に焦点を当てることで、リソースを効果的に配分できる。 |
| 2. **ステークホルダーとのコミュニケーション**: ユーザーストーリーは、プロジェクトの進捗状況やデザインの説明に役立ちます。ステークホルダーがユーザーストーリーを理解することで、デザインの意図や目標について共通の理解が得られ、効率的な意思決定が可能になります。 | ||
| ユーザーストーリーを活用することで、デザイナーは以下のような利点も享受できる。 | ||
| 1. **デザインの優先順位付け**: ユーザーストーリーは、デザインの優先順位を決定する際の指標として役立つ。重要なユーザーストーリーに対応する機能や要素に焦点を当てることで、リソースを効果的に配分することが可能である。 | ||
| 2. **ステークホルダーとのコミュニケーション**: ユーザーストーリーは、プロジェクトの進捗状況やデザインの説明に役立つ。ステークホルダーがユーザーストーリーを理解することで、デザインの意図や目標について共通の理解が得られ、効率的な意思決定が可能となる。 |
There was a problem hiding this comment.
Suggested change
| 2. **ステークホルダーとのコミュニケーション**: ユーザーストーリーは、プロジェクトの進捗状況やデザインの説明に役立つ。ステークホルダーがユーザーストーリーを理解することで、デザインの意図や目標について共通の理解が得られ、効率的な意思決定が可能となる。 | |
| 2. **ステークホルダーとのコミュニケーション**: ユーザーストーリーは、プロジェクトの進捗状況やデザインの説明に役立つ。ステークホルダーがユーザーストーリーを理解することで、デザインの意図や目標について共通の理解が得られ、効率的な意思決定が可能になる。 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.